開發文件/平台/SSP/ShellDescript

descript.txt †

概要 †

shell的基本設定文件。
用於shell名和作者情報、對話框的顯示位置設定、主菜單（右鍵菜單）的画像設定，衣物的所屬菜單顯示設定。

記述例和基本用法 †

charset,Shift_JIS
type,shell
name,master

craftman,ukadog
craftmanw,うか犬
craftmanurl,http://ssp.shillest.net/ukadoc/manual/index.html

menu.background.bitmap.filename,menu_background.png
menu.foreground.bitmap.filename,menu_foreground.png
menu.sidebar.bitmap.filename,menu_sidebar.png

sakura.balloon.offsetx,0
sakura.balloon.offsety,80
kero.balloon.offsetx,-20
kero.balloon.offsety,10
sakura.balloon.alignment,none
kero.balloon.alignment,none

sakura.bindgroup0.name,服,エプロンドレス,apron
sakura.bindgroup1.name,リボン,白リボン,ribbonwhite
sakura.bindgroup2.name,服,黒服,black
sakura.bindgroup3.name,リボン,黒リボン,ribbonblack
sakura.bindgroup0.default,1
sakura.bindgroup1.default,1

kero.bindgroup0.name,ネクタイ,ネクタイ
kero.bindgroup1.name,腕章,黒腕章
kero.bindgroup2.name,腕,ドリル
kero.bindgroup0.default,1
kero.bindgroup1.default,1

sakura.menuitem0,2
sakura.menuitem1,3
sakura.menuitem2,-
sakura.menuitem3,0
sakura.menuitem4,1

kero.menuitem0,0
kero.menuitem1,1
kero.menuitem2,-
kero.menuitem3,2

type、name必恬。
SSP通過對shell的homeurl的設定，可以用資源管理器進行網路更新。
衣物的設定各項目参照後述各節。
基本結構在surfaces.txt定義，定時bind的animationID，衣物名和衣物類別名設定（sakura(kero).bindgroup*.name,～）、需要指定主菜單配置（sakura(kero).menuitem*,～）。
另外，從安全的角度出發，\或%開始的字符串因為可以作為sakura script或環境變量的標誌，所以會被拋棄。如果需要含有這些字符的情況下，請使用\\或\%這樣的跳脫符。
seriko的設定優先級為：人格descript.txt 全体指定＜人格Scope個別指定＜shell的descript.txt全体指定＜shell的Scope個別指定

surfaces.txt或surfaces**.txt †

surface的具體定義記錄在surfaces**.txt（**為0~2個任意字符）中。除charset外都以大括弧範圍的域表示，例如：

charset,UTF-8

descript
{
version,1
}
 
Surface0
{
...
}

sakura.surface.alias
{
...
}

sakura.cursor
{
...
}

sakura.tooltips
{
...
}

域內描述動畫效果使用的格式為SERIKO格式。
其中，SERIKO/2.0 和 SERIKO/1.x 不同點如下。

1. 項名開頭帶 animation
2. pattern 項參數的順序變更
3. interval 參數從10ms 單位變為1ms 單位
4. alternativestart 方法的ID 指定的括號從[ ] 變更為( )
   
   每個域具體如下：

   charset,文字編碼	此文檔顯示編碼，繁體中文Big5, 簡體中文GB2312, 日文Shift-JIS或其他(UTF-8)
   descript域
   version,*	使用的SERIKO格式的版本，0為SERIKO/1.x版，1為SERIKO/2.0版，省略時為0
   maxwidth,像素	surface最大寬度。SSP由於會自動檢測，所以不需要使用這項信息
   collision-sort,排序方式	觸碰檢測排序（從前向後）。ascend升序(1,2,3...) descend降序(10,9,8...)。默認none（ID先定義的在前）
   animation-sort,排序方式	動畫ID排序（從前向後）。ascend升序(1,2,3...) descend降序(10,9,8...)。默認descend
   surface域/surface.append域
   surface*定義對應id的surface，surface.append*為對已定義的id進行追加定義。 其中*對應的id可以是多個，如 0,1,5 的形式，或 1-9 範圍選擇的形式，也可以是混合的1-9,20-29形式
   element*,效果參數,檔案名,X座標,Y座標	基礎surface的定義，之後該surface的動畫效果都是在這個基礎surface上進行處理的
   animation*.interval,時間間隔定義	動畫效果開始發生的時間間隔，時間間隔定義後述， SERIKO/1.x版：*interval
   animation*.pattern*,效果參數,surface編號,等待時間,X座標,Y座標	動畫效果的每一幀設定，參數定義後述，等待時間部份處數值外還可以用 最小時間-最大時間 的形式表示時間範圍內的隨機選擇 SERIKO/1.x版：*pattern*
   animation*.option,exclusive	該定義使此動畫效果不受其他動畫效果的影響，像animation*.option,exclusive,(1,3,5)的寫法，將限定在指定的動畫效果ID內
   animation*.option,background	該定義使此動畫效果在基礎surface後方顯示
   animation*.option,exclusive+background	同時混合上面2種效果，如animation*.option,exclusive+background,(1,3,5)，僅exclusive受影響
   animation*.collision*,觸碰判定定義 animation*.collisionex*,觸碰判定定義(ex)	觸碰判定定義和下面相同時，僅動畫效果運行時有效觸碰判定。bind時也有效。
   collision*,始点X,始点Y,終点X,終点Y,觸碰判定名	定義觸碰判定範圍及名稱
   collisionex*,觸碰判定名,類型,座標1,座標2...	定義不規則觸碰判定範圍及名稱，類型為： rect 長方形。座標為始点XY和終点XY這4個。 ellipse 橢圓。座標為包圍楕円的長方形的始点XY和終点XY這4個。 polygon 多角形。座標各頂点，可交差。
   sakura.balloon.offsetx,座標	/0側僅該surface的balloon位置X座標
   sakura.balloon.offsety,座標	/0側僅該surface的balloon位置Y座標
   kero.balloon.offsetx,座標	/1側僅該surface的balloon位置X座標
   kero.balloon.offsety,座標	/1側僅該surface的balloon位置Y座標
   balloon.offsetx,座標	僅該surface的balloon位置X座標（無論哪一側）
   balloon.offsety,座標	僅該surface的balloon位置Y座標（無論哪一側）
   point.centerx,座標	surface中心X座標。默認surface中心(寬÷2)
   point.centery,座標	surface中心Y座標。默認surface中心(高÷2)
   point.kinoko.centerx,座標	kinoko產生處的X座標。默認surface中心(寬÷2)
   point.kinoko.centery,座標	kinoko產生處的Y座標。默認surface上端＋20像素向下
   point.basepos.x,座標	shell中心X座標。默認surface中心(寬÷2)
   point.basepos.y,座標	shell中心Y座標。默認surface下端
   sakura.surface.alias域/kero.surface.alias域/char*.surface.alias域
   *,[*]	aliasID對任意surfaceID的設定。 例如：驚訝,[2] ，\s[驚訝]和\s[2]同義。 又如，1,[1,11,21]時，\s[1]隨機等同於\s[1],\s[11],\s[21]。
   sakura.cursor域/kero.cursor域/char*.cursor域
   mouseup*,觸碰判定名,檔案名	觸碰判定上方時遊標文件設定
   mousedown*,觸碰判定名,檔案名	觸碰判定點擊時遊標文件設定
   mousewheel*,觸碰判定名,檔案名	觸碰判定滾動時遊標文件設定
   mousehover*,觸碰判定名,檔案名	觸碰判定懸停時遊標文件設定
   sakura.tooltips域/kero.tooltips域/char*.tooltips域
   觸碰判定名,顯示文本	觸碰判定的tooltips的顯示文本設定

時間間隔定義

效果參數

參數ID-1該動畫效果停止，-2所有動畫效果停止

系統遊標 遊標檔案名可指定系統遊標

surfacetable.txt †

概要 †

SSP開發面板的Surface Test功能內容定義用文件。

基本用法 †

charset,Shift_JIS
version,1
option,DisableNoDefineSurfaces

//==========パーツ==========
group,__disabled
{
	19,__parts
}

//==========クー==========
group,[空]平日
{
	scope,0
	
	0,素
	1,照れ
	3,不安
	4,はぅー
	5,笑
}

從//開始為注釋

外部連結 †

• UKADOC descript.txt
  
• UKADOC surfaces.txt
  
• UKADOC surfacetable.txt